Function: toggleAttribute(domElementOrNodeArrayOrCSSSelector, stringAttributeNameOrKeyValueMap, boolValue)

Shorthand: toggleAttr(domElementOrNodeArrayOrCSSSelector, stringAttributeNameOrKeyValueMap, boolValue)

Description: Toggles the boolean value of a specified attribute for a DOM element, markup string, or CSS selector referenced element.

Returns: domElement or matching node array, or $A object if chained.

Example:

// Toggle an attribute on a DOM element
$A.toggleAttribute(domElement, "hidden");

// Toggle multiple attributes on an array of DOM elements
$A.toggleAttribute([domElement1, domElement2], "disabled", true);

// Toggle multiple attributes on multiple DOM elements referenced by a CSS selector
$A.toggleAttribute('form input[type="text"]', "required", false);